Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_WRITEATTR

EOS_PT_WRITEATTR

This function writes/updates an attribute in a point. If the attribute does not exist, it is created. If it does exist, then the value(s) is (are) updated.

Syntax

Result = EOS_PT_WRITEATTR( pointID, attrname, datbuf [, COUNT=value] [, HDF_TYPE=value] )

Return Value

Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

Arguments

pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

attrname

Attribute name (string).

datbuf

Attribute values.

Keywords

COUNT

Number of values (long) to store in attribute.

HDF_TYPE

Number type (long) of attribute..

Examples

In this example, we write a single precision (32 bit) floating point number with the name “ScalarFloat” and the value 3.14:

f32 = 3.14f

status = EOS_PT_WRITEATTR(pointid, "ScalarFloat", f32)

We can update this value by simply calling the function again with the new value:

f32 = 3.14159

status = EOS_PT_WRITEATTR(pointid, "ScalarFloat", f32)

Version History

5.2	Introduced